Contactos [Desarrolladores]
Consulta y gestiona los contactos (usuarios/clientes) de tu cuenta Adereso desde la API.
Contactos
Los contactos representan a los usuarios finales (clientes) que interactúan con tu empresa a través de los distintos canales conectados en Adereso. Desde la API puedes listar contactos y obtener información detallada de cada uno.
¿Para qué sirve?
Los contactos son todas las personas que han interactuado con tu empresa a través de cualquier canal conectado en Adereso (WhatsApp, email, Instagram, chat, etc.). Esta API te permite consultar tu base de contactos.
Beneficios concretos
- Sincronizar la base de contactos de Adereso con tu CRM u otro sistema
- Buscar información de un cliente específico para atenderlo mejor
- Generar reportes de actividad de clientes (quién escribió recientemente, cuántos contactos tienes, etc.)
¿Quién lo usa? Equipos de ventas, soporte y operaciones que necesitan visibilidad de los contactos de Adereso en otros sistemas.
Listar contactos
/v2/contacts/ - GET
Obtiene una lista paginada de todos los contactos de tu cuenta. Puedes ordenar por nombre o fecha del último mensaje, y filtrar por rango de fechas.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
page | integer | No | Número de página (empieza en 1) |
order_by | string | No | Ordenamiento: uname_asc, uname_desc, last_message_asc, last_message_desc |
last_message_from | string | No | Filtrar contactos con último mensaje desde esta fecha. Formato: YYYY-MM-DD o YYYY-MM-DDTHH:MM:SS |
last_message_to | string | No | Filtrar contactos con último mensaje hasta esta fecha. Mismo formato |
Ejemplo de request
curl -H "Authorization: Key TU_TOKEN" \
"https://api-cluster.adere.so/v2/contacts/?page=1&order_by=last_message_desc&last_message_from=2026-01-01"Ejemplo de respuesta exitosa:
{
"status": 200,
"contacts": [
{
"id": "5f8a1b2c3d4e5f6789012345",
"name": "María López",
"email": "maria@empresa.com",
"phone": "56911111111",
"last_message": "2026-03-15T10:30:00Z"
}
],
"total_pages": 5
}Detalle de un contacto
/v2/contacts/{user_id}/ - GET
Obtiene información detallada de un contacto específico, incluyendo sus datos de perfil y canales asociados.
Parámetros
Parámetro | Tipo | Requerido | Descripción |
user_id | string | Sí | ObjectId del usuario (obtenido del listado de contactos) |
Ejemplo de request
curl -H "Authorization: Key TU_TOKEN" \
"https://api-cluster.adere.so/v2/contacts/5f8a1b2c3d4e5f6789012345/"Ejemplo de respuesta exitosa:
{
"status": 200,
"contact": {
"id": "5f8a1b2c3d4e5f6789012345",
"name": "María López",
"email": "maria@empresa.com",
"phone": "56911111111",
"channels": ["whatsapp", "email"],
"created": "2025-06-01T14:00:00Z",
"last_message": "2026-03-15T10:30:00Z"
}
}Códigos de error
Código | Descripción |
401 | No autenticado |
404 | Contacto no encontrado |